home *** CD-ROM | disk | FTP | other *** search
/ Workbench Add-On / Workbench Add-On - Volume 1.iso / BBS-Archive / Util / Time / mbwatch.lha / mbwatch / mbwatch.doc < prev   
Text File  |  1995-05-26  |  6KB  |  174 lines
  1.                                     MBWatch
  2.                                     =======
  3.  
  4. About this program
  5. ==================
  6.  
  7. This is the 3rd release of my timer program. I've written this program in  order
  8. to  have a small, handy timer to control the time I spend e.g on IRC and to help
  9. me, reduce my phonebills. I've been searching for such a  program  for  quite  a
  10. long  time  and didn't find any comparable tool. And this stuff like e.g MagicCX
  11. is IMHO quite too buggy and eats too much of my valuable memory.  In  the  first
  12. place  my  intention  was,  to  leave  this  program  as  small as possible, but
  13. meanwhile I've added some quite useful features and it got slightly  bigger  and
  14. it'll  grow  a  bit  in  the future. So, if you'd like to have some more special
  15. features in this program, please be so kind and let me know  your  very  special
  16. needs.  I  won't implement everything, but as you might notice, I've implemented
  17. some wishes by some users of my first version.
  18.  
  19. Usage
  20. =====
  21.  
  22. Start MBWatch by starting it from a shell or from a script.
  23.  
  24.     MBWatch X=XPOS/N,Y=YPOS/N,SCR=SCREEN/K,S=START/S,LOGTIME/N,SEC/N,MIN/N,HOUR/N,
  25.             ALARM/N,SAMPLE/K
  26.  
  27.     XPOS        Left Edge of the Window
  28.                                         !!! Currently, I don't check your values
  29.     YPOS        Top Edge of the Window
  30.  
  31.     SCREEN      You may enter the name of your favorite PubScreen
  32.  
  33.     START       The timer is resetted and starts automatically
  34.  
  35.     LOGFILE     Enable the Log Function.
  36.  
  37.     LOGTIME     Time distance in seconds. MBWatch will update the s:.mbwatch
  38.                 file after n seconds. If you start MBWatch a second time after
  39.                 e.g a crash, it'll continue with the last logtime. This file
  40.                 will be deleted, everytime you leave MBWatch the "normal" way.
  41.  
  42.     SEC         This will give you a certain time offset. E.g the timer starts
  43.     MIN         to count about half a minute after the handshake has started,
  44.     HOUR        so you'll be able to give a preset.
  45.  
  46.     ALARM       You may set an alarm time in seconds. When the given time is
  47.                 over, there'll be either a DisplayBeep or an 8svx sample will
  48.                 be played.
  49.  
  50.     SAMPLE      If you place the path to an 8svx sample here, it'll be played
  51.                 when the alarmtime has passed.
  52.  
  53. ARexx
  54. =====
  55.  
  56. MBTimer installs an ARexx port for each Window you open. They'll be named
  57. 'MBWATCH.00' through 'MBWATCH.99'.
  58.  
  59.     Commands:
  60.  
  61.         START       Start the timer
  62.  
  63.         STOP        Stop the timer
  64.  
  65.         RESET       Reset the timer
  66.  
  67.         QUIT        Quit this program
  68.  
  69.         GETTIME     Return the time string
  70.  
  71.     Invocation via e.g your shell:
  72.  
  73.         rx "ADDRESS MBWATCH.01; START"
  74.  
  75. OnlineWatch-2
  76. =============
  77.  
  78. This script is (c) by Dirk M. Oppelt. (Dimik@#amigager)
  79.  
  80. OnlineWatch-2 is a Shell script that stops the timer, reads  the  actual  online
  81. time,  gives  you  some  information  and writes a logfile. There'll be a single
  82. logfile for every month. This logfile is only for the german telekom phonebills,
  83. but  I  guess  it could be adapted to your country without problems. To use this
  84. script you simply have to execute it when you stop using your  phone,  the  rest
  85. will be done automagically.
  86.  
  87. Currently OnlineWatch-2 doesn't support holidays.
  88.  
  89. The logfiles will be placed in s:gebuehren/
  90.  
  91. A better doc for this function will follow soon ;-)
  92.  
  93. How I use this program
  94. ======================
  95.  
  96. I use Jochen Wiedmann's IPDial to startup my slip  line  via  AmiTCP.  When  the
  97. connection  is established, I use the script (and my enhanced version of IPStart
  98. - I'll give it to Jochen soon ;c) ) to start MBWatch and to start the timer.  In
  99. my Stopnet script I stop this timer again.
  100.  
  101. Legal Stuff
  102. ===========
  103.  
  104. This program is Giftware. If you like this program, I'd be glad if you'd send me
  105. something.  A  huge  bag  full  of  money, a cd, a new car, hmmm, what about ...
  106. *grin*. No, give me some response, send me your suggestions, tell  me  what  you
  107. like about this program, or tell me what you'd like to see in future versions.
  108.  
  109. I've decided to publish this program as GWAR-Ware. Perhaps you'd like to know one
  110. important thing: 'What the fuck is GWAR ?'. GWAR is one of the best bands in the
  111. entire universe. If you like this program, you'll have to buy either a GWAR CD or
  112. go to a GWAR concert !!!
  113.  
  114. Future Plans
  115. ============
  116.  
  117.     o   Including more shell arguments
  118.     o   Fixing some stupid things
  119.     o   Perhaps your idea ...
  120.     o   A better documentation
  121.     o   Perhaps a log function for e.g PhoneBill or similar programs
  122.  
  123. History
  124. =======
  125.  
  126.     1.0b    First official release
  127.  
  128.     1.0a    Added Ctrl-C handling
  129.             Added the GetTime ARexx command
  130.  
  131.     1.0     Added a logfile option
  132.             Removed autoactivation of the window.
  133.             Added Alarm function
  134.             Added Preset capability
  135.             Now you can add several windows
  136.             Window will open on the DefaultPubScreen if the given screen is not
  137.                 available.
  138.  
  139.     1.1     The logfile option must be switched on with the LOGFILE keyword
  140.             Added Dirk's Logscript
  141.             Fixed some minor bugs
  142.  
  143. Thank you
  144. =========
  145.  
  146.     Dirk M. Oppelt (Dimik) for the wonderful Script.
  147.  
  148.     Jochen Wiedmann for his incredible IPDial.
  149.  
  150.     To GWAR, Colloseum, Emerson Lake & Palmer, Faith no more, Rainbow
  151.  
  152.         Their music inspired me while working on this program.
  153.  
  154.     3 or 4 guys who gave me some inspirations about this program.
  155.  
  156.         Sorry, I don't know, where the piece of paper with your names has
  157.         gone. The only one I can remember right now is 'obw' at #amigager.
  158.  
  159.     All the people at #amigager
  160.  
  161. Author
  162. ======
  163.  
  164.     Michael Bauer
  165.     Hegelstr. 27
  166.     72072 Tuebingen
  167.     07071/72293
  168.  
  169.     EMail: michael.bauer@zdv.uni-tuebingen.de (this one is preferred)
  170.     or     u195305@pluto.rz.fh-reutlingen.de
  171.     IRC:   Gutgolf@#amigager
  172.     WWW:   http://pluto.rz.fh-reutlingen.de/~u195305/index.html
  173.  
  174.